home *** CD-ROM | disk | FTP | other *** search
/ Software Club 1 / Club Software (Micro Star) (1996).iso / copyp / copyplus.doc < prev    next >
Encoding:
Text File  |  1995-07-30  |  11.9 KB  |  286 lines
  1.  
  2.  
  3.  
  4.           Copy+ 2.13                                  by Gerald R. Brown
  5.           --------------------------------------------------------------
  6.  
  7.           Copy diskettes when formats are different. Copy, move, rename
  8.           or erase specified files in a directory, entire branch or
  9.           disk. Requires DOS 3.2 or later. May be run from Windows.
  10.  
  11.           Copy+' syntax is:
  12.  
  13.              COPYPLUS [/S] [/M] [/P] [/E] [/Y] [/H] [source] [target]
  14.  
  15.             source    Specifies the file(s) to copy, move or prune. If
  16.                       no file specification is included, all files
  17.                       (*.*) will be assumed.
  18.  
  19.             target    Specifies the location and/or name of copied
  20.                       files. To rename files include a filename.
  21.  
  22.             /S        Option to include all subdirectories below
  23.                       source. All files in the source directory and
  24.                       below which match the source file specification
  25.                       will be copied to an identical tree structure,
  26.                       beginning with the target directory. If included
  27.                       with the Prune (/P) or Move (/M) option, all
  28.                       files matching the source file specification
  29.                       below the source directory will also be erased.
  30.                       If /S is omitted only files in the source
  31.                       directory will be copied, moved or pruned. Note:
  32.                       If the target is within the source's branch a
  33.                       cyclic copy error is detected and no copy is
  34.                       performed.
  35.  
  36.             /M        Option to move files. All files matching the
  37.                       source file specification will be erased after
  38.                       they are copied.
  39.  
  40.             /P        Option to prune files. All files matching the
  41.                       source file specification will be erased. No files
  42.                       will be copied. A target specification is ignored.
  43.  
  44.             /E        Option to keep empty subdirectories. All empty
  45.                       subdirectories are copied and no subdirectories
  46.                       are erased. If /E is omitted no empty directories
  47.                       are copied and empty directories are deleted.
  48.  
  49.             /Y        Option to assume a "Yes" response and suppress
  50.                       certain prompts. If /Y is omitted you will be
  51.                       warned and offered an opportunity to change disks,
  52.                       abort or continue with the current disk before
  53.                       formatting or erasing existing data on the target.
  54.                       Also, with DOS 6.2, you will be warned and offered
  55.                       an opportunity to skip overwriting existing files.
  56.  
  57.           Copy+ 2.13                                         Page 1 of 5
  58.  
  59.  
  60.  
  61.             /H or /?  Display help screen.
  62.  
  63.           If no option is specified files matching the source file
  64.           specification in the source directory will be copied to the
  65.           target directory. Directories below the source will not be
  66.           included. No files will be erased.
  67.  
  68.           Copy+ supports wildcards and is not case-sensitive.
  69.  
  70.           If the drive and root specifiers (d:\) are omitted Copy+
  71.           assumes the path specified is below the current directory.
  72.           If only the root specifier (leading \) is omitted, Copy+
  73.           provides it for you. If you are in C:\DOS and specify a source
  74.           or target of "BIN", Copy+ operates as if "C:\DOS\BIN" were
  75.           specified. If "C:*.BAT" is specified, Copy+ operates as if
  76.           "C:\*.BAT" were specified. 
  77.  
  78.           To copy, move or prune an entire disk, specify the drive only
  79.           (d:) as the source. If the target specification is a drive
  80.           only and the target isn't a hard disk or CD-ROM, all files on
  81.           the target will be erased before the copy or move. "COPYPLUS
  82.           A: B:" will erase all files on the target and copy all files
  83.           from A: to B:, even if their formats are different.
  84.           "COPYPLUS A: B:\" will copy all files from A: to B:, leaving
  85.           existing files as they were. Versions of DOS prior to 6.2
  86.           overwrite files of the same name with no warning. With DOS
  87.           6.2 you will be prompted before overwriting. Also with DOS
  88.           6.2, hidden and system files are neither copied nor erased.
  89.  
  90.           The target cannot be below the source. Such a specification
  91.           would be a circular reference.
  92.  
  93.           The following DOS utilities must be located in a subdirectory
  94.           in DOS' path environment variable:
  95.  
  96.             XCOPY.EXE     Copies directories, branches and files
  97.             FORMAT.COM    Formats disk if necessary
  98.             DISKCOPY.COM  Duplicates disk in same drive
  99.  
  100.           Copy+ determines the disk space required before executing the
  101.           command. If insufficient space is found, it returns you to
  102.           DOS, displaying the space required and available.
  103.  
  104.           If a general failure occurs, usually caused by an unformatted
  105.           diskette, Copy+ displays the following prompt:
  106.  
  107.             General failure - d:
  108.             Change diskette and press [N] to check it, press [ESC] to
  109.             abort or press any other key to format the current
  110.             diskette.
  111.  
  112.  
  113.  
  114.           Page 2 of 5                                         Copy+ 2.13
  115.  
  116.  
  117.  
  118.           You may change the disk and check it by pressing [N]. Press
  119.           [ESC] to abort. Press any other key and Copy+ will continue
  120.           with the current disk, displaying the following prompt:
  121.  
  122.             Format to [3]60K, [7]20K, 1.[2]M, 1.[4]4M or [ESC] to abort.
  123.  
  124.           Press the number in brackets for the proper size. DOS' format
  125.           will be invoked. Press [ESC] to abort.
  126.  
  127.           If the target specifier is a drive only (d:) and it has files
  128.           on it, Copy+ displays the following prompt:
  129.  
  130.             Data exists - d:
  131.             Change diskette and press [N] to check it, press [ESC] to
  132.             abort or press any other key to continue with current
  133.             diskette.
  134.  
  135.           You may change the diskette and check it by pressing [N].
  136.           Press [ESC] to abort. Press any other key and Copy+ will
  137.           continue by 'quick' formatting the current diskette.
  138.  
  139.           Copy+ detects write-protected diskettes. The source may be
  140.           write-protected unless you specify the Move (/M) or Prune
  141.           (/P) option. Copy+ also detects a drive with no diskette or
  142.           with the drive door open (Disk not ready). You will be
  143.           prompted and offered an opportunity to correct the error or
  144.           abort and return to DOS if either of these errors occurs. Any
  145.           other error causes Copy+ to display a description and return
  146.           to DOS with an errorlevel for batch file interrogation. Most
  147.           represent DOS' error codes. Others are Copy+ specific.
  148.  
  149.           Copy+ specific errors are:
  150.             127  Insufficient disk space
  151.             126  Target specified (no pathname) is a hard disk
  152.             125  Target specified is on a CD-ROM
  153.             124  DOS 3.2 or later required
  154.             123  Bad FAT detected
  155.             122  Bad syntax
  156.             121  Too many clusters (maximum 65,536)
  157.             120  Cyclic copy (copying subdirectories when target is
  158.                  within the source
  159.             117  Format not supported
  160.             116  Unable to create volume label
  161.  
  162.           DOS' error codes (incomplete) are:
  163.              36  Unidentified error
  164.              35  FCB unavailable
  165.              34  Invalid disk change
  166.              33  Lock violation
  167.              32  Sharing violation
  168.              31  General failure (usually disk not formatted)
  169.              30  Read fault
  170.  
  171.           Copy+ 2.13                                         Page 3 of 5
  172.  
  173.  
  174.  
  175.              29  Write fault
  176.              28  Printer out of paper
  177.              27  Sector not found
  178.              26  Unknown media type
  179.              25  Seek error
  180.              24  Bad request structure length
  181.              23  Data error
  182.              22  Unknown command
  183.              21  Drive not ready
  184.              20  Unknown disk unit
  185.              19  Disk write-protected
  186.              18  No more files
  187.              17  Not same device
  188.              16  Attempt to move current directory
  189.              15  Invalid disk drive
  190.              14  Reserved
  191.              13  Invalid data
  192.              12  Invalid access code
  193.              11  Invalid format
  194.              10  Invalid environment
  195.               9  Invalid memory block address
  196.               8  Insufficient memory
  197.               7  Memory control blocks destroyed
  198.               6  Invalid handle
  199.               5  Access denied
  200.               4  Too many open files
  201.               3  Path not found
  202.               2  File not found
  203.               1  Invalid function number
  204.               0  Successful
  205.  
  206.           Revision History:
  207.  
  208.                2.10 7/8/94
  209.  
  210.                     Initial release
  211.  
  212.                2.12 9/8/94
  213.  
  214.                     Fixed problem when pruning, and more than one space
  215.                     was included between the options and the pathname.
  216.                     The entire default disk was deleted.
  217.  
  218.                     Fixed problem when pruning or moving, and a bad
  219.                     sector was detected on the target disk. The source
  220.                     was deleted anyway.
  221.  
  222.                     Fixed problem when pruning and wildcards were
  223.                     specified. The wildcards weren't accepted.
  224.  
  225.                     Fixed problem when an invalid path was specified. No
  226.                     error message was displayed.
  227.  
  228.           Page 4 of 5                                      Copy+ 2.13
  229.  
  230.  
  231.  
  232.                     Fixed problem when a target of one character was
  233.                     specified with only one option. An invalid syntax
  234.                     error was displayed.
  235.  
  236.                2.13 7/22/95
  237.  
  238.                     Fixed a problem when filename specification was in
  239.                     other than the root. The entire subdirectory was
  240.                     included.
  241.  
  242.                     Fixed a problem when the Subdirectory option was
  243.                     specified and the target was a subdirectory of the
  244.                     source. A Cyclic Copy occured and DOS returns no
  245.                     error code to interpret. If the Prune or Move
  246.                     option was specified the source files were erased
  247.                     though they were never copied.
  248.  
  249.           Users of Copy+ must accept this disclaimer of warranty:
  250.           "Copy+ is supplied as is. The author disclaims all
  251.           warranties, expressed or implied, including, without
  252.           limitation, the warranties of merchantability and of fitness
  253.           for any purpose. The author assumes no liability for damages,
  254.           direct or consequential, which may result from the use of
  255.           Copy+."
  256.  
  257.           You are encouraged to pass a copy of Copy+ along to your
  258.           friends for evaluation. Anyone distributing Copy+ for any
  259.           kind of remuneration must first contact me for authorization.
  260.           This is shareware. You are offered an opportunity to examine
  261.           this software for 60 days. If you continue to use it after
  262.           the trial period you must fill out the registration form and
  263.           send it with $10.00 (US) to:
  264.  
  265.  
  266.  
  267.                                  Gerald R. Brown
  268.                                19540 Willsie Drive
  269.                       Lake Elsinore, California  92530-6431
  270.                                   (909)678-3229
  271.                    Internet Address: 71023,243@compuserve.com
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.           (C) COPYRIGHT 1995   GERALD R. BROWN   ALL RIGHTS RESERVED
  284.  
  285.           Copy+ 2.13                                         Page 5 of 5
  286.